<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
<head>
  <meta charset="utf-8" />
  <meta name="generator" content="pandoc" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
  <title>DFU-PREFIX</title>
  <style type="text/css">
      code{white-space: pre-wrap;}
      span.smallcaps{font-variant: small-caps;}
      span.underline{text-decoration: underline;}
      div.column{display: inline-block; vertical-align: top; width: 50%;}
  </style>
</head>
<body>
<header id="title-block-header">
<h1 class="title">DFU-PREFIX</h1>
<p class="date">September 2021</p>
</header>
<h1>NAME</h1>
<p>dfu-prefix - add, check, or remove special firmware file prefix</p>
<h1>SYNOPSIS</h1>
<p><strong>dfu-prefix</strong> [ <strong>-s</strong> <em>address</em> | <strong>-L</strong> ] <strong>--add</strong> <em>DFU_FILE</em></p>
<p><strong>dfu-prefix</strong> [ <strong>-T</strong> | <strong>-L</strong> ] <strong>--check</strong> <em>DFU_FILE</em></p>
<p><strong>dfu-prefix</strong> [ <strong>-T</strong> | <strong>-L</strong> ] <strong>--delete</strong> <em>DFU_FILE</em></p>
<p><strong>dfu-prefix</strong> <strong>--help</strong></p>
<p><strong>dfu-prefix</strong> <strong>--version</strong></p>
<h1>DESCRIPTION</h1>
<p>The program <strong>dfu-prefix</strong> can be used to add, check or remove a prefix used by certain hardware manufacturers. The Stellaris format from TI and the LPC format from NXP is supported.</p>
<p>Note that a standard DFU firmware file has no concept of a prefix, and a DFU host tool like dfu-util passes the prefix on to the device as part of the normal firmware payload.</p>
<h1>OPTIONS</h1>
<dl>
<dt><strong>-s, --stellaris-address <em>address</em></strong></dt>
<dd><p>(in combination with --add) Add TI Stellaris address prefix to file</p>
</dd>
<dt><strong>-T, --stellaris</strong></dt>
<dd><p>(in combination with --delete or --check) Act on TI Stellaris address prefix of file</p>
</dd>
<dt><strong>-L, --lpc-prefix</strong></dt>
<dd><p>(in combination with --add or --delete or --check) Use NXP LPC DFU prefix format</p>
</dd>
<dt><strong>-h, --help</strong></dt>
<dd><p>Displays a help message.</p>
</dd>
<dt><strong>-V, --version</strong></dt>
<dd><p>Displays the software version.</p>
</dd>
</dl>
<h1>EXAMPLES</h1>
<dl>
<dt><strong><strong>dfu-prefix</strong> --stellaris-address 0x0100 --add firmware.dfu</strong></dt>
<dd><p>Adds a Stellaris prefix with load address 0x0100</p>
</dd>
<dt><strong><strong>dfu-prefix</strong> --stellaris --check firmware.dfu</strong></dt>
<dd><p>Checks the file firmware.dfu for a Stellaris prefix</p>
</dd>
<dt><strong><strong>dfu-prefix</strong> --lpc-prefix --delete firmware.dfu</strong></dt>
<dd><p>Removes a LPC prefix from the file firmware.dfu</p>
</dd>
</dl>
<h1>EXIT VALUES</h1>
<dl>
<dt><strong><strong>0</strong></strong></dt>
<dd><p>Success (also if prefix is missing)</p>
</dd>
<dt><strong><strong>-64</strong></strong></dt>
<dd><p>Usage error</p>
</dd>
</dl>
<h1>BUGS</h1>
<p>https://sourceforge.net/p/dfu-util/tickets/</p>
<h1>COPYRIGHT</h1>
<p>License GPLv2: GNU GPL version 2</p>
<h1>SEE ALSO</h1>
<p><strong>dfu-suffix</strong>(1), <strong>dfu-util</strong>(1)</p>
<h1>AUTHORS</h1>
<p>See AUTHORS file in source.</p>
</body>
</html>
